Node / meshtastic / Meshtastic-Android / files / feature / firmware / src / commonTest / kotlin / org / meshtastic / feature / firmware / DefaultFirmwareUpdateManagerTest.kt

Displaying Raw • Download

T8b949e/*

* Copyright (c) 2026 Meshtastic LLC

*

* This program is free software: you can redistribute it and/or modify

* it under the terms of the GNU General Public License as published by

* the Free Software Foundation, either version 3 of the License, or

* (at your option) any later version.

*

* This program is distributed in the hope that it will be useful,

* but WITHOUT ANY WARRANTY; without even the implied warranty of

* MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the

* GNU General Public License for more details.

*

* You should have received a copy of the GNU General Public License

* along with this program. If not, see <https://www.gnu.org/licenses/>.

*/

Tff7b72package T7ee787org.meshtastic.feature.firmware

Tff7b72import T7ee787dev.mokkery.MockMode

Tff7b72import T7ee787dev.mokkery.answering.returns

Tff7b72import T7ee787dev.mokkery.every

Tff7b72import T7ee787dev.mokkery.mock

Tff7b72import T7ee787kotlinx.coroutines.Dispatchers

Tff7b72import T7ee787kotlinx.coroutines.flow.MutableStateFlow

Tff7b72import T7ee787org.meshtastic.core.ble.BleConnectionFactory

Tff7b72import T7ee787org.meshtastic.core.ble.BleScanner

Tff7b72import T7ee787org.meshtastic.core.di.CoroutineDispatchers

Tff7b72import T7ee787org.meshtastic.core.model.DeviceHardware

Tff7b72import T7ee787org.meshtastic.core.repository.NodeRepository

Tff7b72import T7ee787org.meshtastic.core.repository.RadioController

Tff7b72import T7ee787org.meshtastic.core.repository.RadioPrefs

Tff7b72import T7ee787org.meshtastic.feature.firmware.ota.Esp32OtaUpdateHandler

Tff7b72import T7ee787org.meshtastic.feature.firmware.ota.dfu.SecureDfuHandler

Tff7b72import T7ee787kotlin.test.Test

Tff7b72import T7ee787kotlin.test.assertEquals

Tff7b72import T7ee787kotlin.test.assertFailsWith

Tff7b72import T7ee787kotlin.test.assertIs

T8b949e/**

* Tests for [DefaultFirmwareUpdateManager] routing logic. Verifies that `getHandler()` selects the correct handler

* based on connection type (BLE/Serial/TCP) and device architecture (ESP32 vs nRF52), and that `getTarget()` returns

* the correct address.

*

* Handler instances are constructed with mocked interface dependencies; only the routing logic (`getHandler` /

* `getTarget`) is exercised — no handler methods are called.

*/

Tff7b72class T56d364DefaultFirmwareUpdateManagerTest Tb4b4b4{

T8b949e// ── Test fixtures ───────────────────────────────────────────────────────

Tff7b72private Tff7b72val Te6edf3esp32Hardware Tff7b72=

Te6edf3DeviceHardwareTb4b4b4(Te6edf3hwModelSlug Tff7b72= Ta5d6ff"Ta5d6ffHELTEC_V3Ta5d6ff"Tb4b4b4, Te6edf3platformioTarget Tff7b72= Ta5d6ff"Ta5d6ffheltec-v3Ta5d6ff"Tb4b4b4, Te6edf3architecture Tff7b72= Ta5d6ff"Ta5d6ffesp32-s3Ta5d6ff"Tb4b4b4)

Tff7b72private Tff7b72val Te6edf3nrf52Hardware Tff7b72=

Te6edf3DeviceHardwareTb4b4b4(Te6edf3hwModelSlug Tff7b72= Ta5d6ff"Ta5d6ffRAK4631Ta5d6ff"Tb4b4b4, Te6edf3platformioTarget Tff7b72= Ta5d6ff"Ta5d6ffrak4631Ta5d6ff"Tb4b4b4, Te6edf3architecture Tff7b72= Ta5d6ff"Ta5d6ffnrf52840Ta5d6ff"Tb4b4b4)

T8b949e// Real handler instances — their internal deps are mocked interfaces but never invoked by these tests.

Tff7b72private Tff7b72val Te6edf3fileHandlerTb4b4b4: Te6edf3FirmwareFileHandler Tff7b72= Te6edf3mockTb4b4b4(Te6edf3MockModeTb4b4b4.Te6edf3autofillTb4b4b4)

Tff7b72private Tff7b72val Te6edf3radioControllerTb4b4b4: Te6edf3RadioController Tff7b72= Te6edf3mockTb4b4b4(Te6edf3MockModeTb4b4b4.Te6edf3autofillTb4b4b4)

Tff7b72private Tff7b72val Te6edf3nodeRepositoryTb4b4b4: Te6edf3NodeRepository Tff7b72= Te6edf3mockTb4b4b4(Te6edf3MockModeTb4b4b4.Te6edf3autofillTb4b4b4)

Tff7b72private Tff7b72val Te6edf3bleScannerTb4b4b4: Te6edf3BleScanner Tff7b72= Te6edf3mockTb4b4b4(Te6edf3MockModeTb4b4b4.Te6edf3autofillTb4b4b4)

Tff7b72private Tff7b72val Te6edf3bleConnectionFactoryTb4b4b4: Te6edf3BleConnectionFactory Tff7b72= Te6edf3mockTb4b4b4(Te6edf3MockModeTb4b4b4.Te6edf3autofillTb4b4b4)

Tff7b72private Tff7b72val Te6edf3firmwareRetriever Tff7b72= Te6edf3FirmwareRetrieverTb4b4b4(Te6edf3fileHandlerTb4b4b4)

Tff7b72private Tff7b72val Te6edf3dispatchers Tff7b72=

Te6edf3CoroutineDispatchersTb4b4b4(

Te6edf3io Tff7b72= Te6edf3DispatchersTb4b4b4.Te6edf3UnconfinedTb4b4b4,

Te6edf3main Tff7b72= Te6edf3DispatchersTb4b4b4.Te6edf3UnconfinedTb4b4b4,

Te6edf3default Tff7b72= Te6edf3DispatchersTb4b4b4.Te6edf3UnconfinedTb4b4b4,

Tb4b4b4)

Tff7b72private Tff7b72val Te6edf3secureDfuHandler Tff7b72=

Te6edf3SecureDfuHandlerTb4b4b4(

Te6edf3firmwareRetriever Tff7b72= Te6edf3firmwareRetrieverTb4b4b4,

Te6edf3firmwareFileHandler Tff7b72= Te6edf3fileHandlerTb4b4b4,

Te6edf3radioController Tff7b72= Te6edf3radioControllerTb4b4b4,

Te6edf3bleScanner Tff7b72= Te6edf3bleScannerTb4b4b4,

Te6edf3bleConnectionFactory Tff7b72= Te6edf3bleConnectionFactoryTb4b4b4,

Te6edf3dispatchers Tff7b72= Te6edf3dispatchersTb4b4b4,

Tb4b4b4)

Tff7b72private Tff7b72val Te6edf3usbUpdateHandler Tff7b72=

Te6edf3UsbUpdateHandlerTb4b4b4(

Te6edf3firmwareRetriever Tff7b72= Te6edf3firmwareRetrieverTb4b4b4,

Te6edf3radioController Tff7b72= Te6edf3radioControllerTb4b4b4,

Te6edf3nodeRepository Tff7b72= Te6edf3nodeRepositoryTb4b4b4,

Tb4b4b4)

Tff7b72private Tff7b72val Te6edf3esp32OtaHandler Tff7b72=

Te6edf3Esp32OtaUpdateHandlerTb4b4b4(

Te6edf3firmwareRetriever Tff7b72= Te6edf3firmwareRetrieverTb4b4b4,

Te6edf3firmwareFileHandler Tff7b72= Te6edf3fileHandlerTb4b4b4,

Te6edf3radioController Tff7b72= Te6edf3radioControllerTb4b4b4,

Te6edf3nodeRepository Tff7b72= Te6edf3nodeRepositoryTb4b4b4,

Te6edf3bleScanner Tff7b72= Te6edf3bleScannerTb4b4b4,

Te6edf3bleConnectionFactory Tff7b72= Te6edf3bleConnectionFactoryTb4b4b4,

Te6edf3dispatchers Tff7b72= Te6edf3dispatchersTb4b4b4,

Tb4b4b4)

Tff7b72private Tff7b72fun Td2a8ffcreateManagerTb4b4b4(Te6edf3addressTb4b4b4: Tffa657String?Tb4b4b4)Tb4b4b4: Te6edf3DefaultFirmwareUpdateManager Tb4b4b4{

Tff7b72val Te6edf3radioPrefsTb4b4b4: Te6edf3RadioPrefs Tff7b72= Te6edf3mockTb4b4b4(Te6edf3MockModeTb4b4b4.Te6edf3autofillTb4b4b4) Tb4b4b4{ Te6edf3every Tb4b4b4{ Te6edf3devAddr Tb4b4b4} Te6edf3returns Te6edf3MutableStateFlowTb4b4b4(Te6edf3addressTb4b4b4) Tb4b4b4}

Tff7b72return Te6edf3DefaultFirmwareUpdateManagerTb4b4b4(

Te6edf3radioPrefs Tff7b72= Te6edf3radioPrefsTb4b4b4,

Te6edf3secureDfuHandler Tff7b72= Te6edf3secureDfuHandlerTb4b4b4,

Te6edf3usbUpdateHandler Tff7b72= Te6edf3usbUpdateHandlerTb4b4b4,

Te6edf3esp32OtaUpdateHandler Tff7b72= Te6edf3esp32OtaHandlerTb4b4b4,

Tb4b4b4)

Tb4b4b4}

T8b949e// ── getHandler: BLE connection ──────────────────────────────────────────

Tf0883e@Test

Tff7b72fun Td2a8ff`BLE + ESP32 routes to OTA handler`Tb4b4b4(Tb4b4b4) Tb4b4b4{

Tff7b72val Te6edf3manager Tff7b72= Te6edf3createManagerTb4b4b4(Ta5d6ff"Ta5d6ffxAA:BB:CC:DD:EE:FFTa5d6ff"Tb4b4b4)

Tff7b72val Te6edf3handler Tff7b72= Te6edf3managerTb4b4b4.Te6edf3getHandlerTb4b4b4(Te6edf3esp32HardwareTb4b4b4)

Te6edf3assertIsTff7b72<Te6edf3Esp32OtaUpdateHandlerTff7b72>Tb4b4b4(Te6edf3handlerTb4b4b4)

Tb4b4b4}

Tf0883e@Test

Tff7b72fun Td2a8ff`BLE + nRF52 routes to Secure DFU handler`Tb4b4b4(Tb4b4b4) Tb4b4b4{

Tff7b72val Te6edf3manager Tff7b72= Te6edf3createManagerTb4b4b4(Ta5d6ff"Ta5d6ffxAA:BB:CC:DD:EE:FFTa5d6ff"Tb4b4b4)

Tff7b72val Te6edf3handler Tff7b72= Te6edf3managerTb4b4b4.Te6edf3getHandlerTb4b4b4(Te6edf3nrf52HardwareTb4b4b4)

Te6edf3assertIsTff7b72<Te6edf3SecureDfuHandlerTff7b72>Tb4b4b4(Te6edf3handlerTb4b4b4)

Tb4b4b4}

T8b949e// ── getHandler: Serial/USB connection ───────────────────────────────────

Tf0883e@Test

Tff7b72fun Td2a8ff`Serial + nRF52 routes to USB handler`Tb4b4b4(Tb4b4b4) Tb4b4b4{

Tff7b72val Te6edf3manager Tff7b72= Te6edf3createManagerTb4b4b4(Ta5d6ff"Ta5d6ffs/dev/ttyUSB0Ta5d6ff"Tb4b4b4)

Tff7b72val Te6edf3handler Tff7b72= Te6edf3managerTb4b4b4.Te6edf3getHandlerTb4b4b4(Te6edf3nrf52HardwareTb4b4b4)

Te6edf3assertIsTff7b72<Te6edf3UsbUpdateHandlerTff7b72>Tb4b4b4(Te6edf3handlerTb4b4b4)

Tb4b4b4}

Tf0883e@Test

Tff7b72fun Td2a8ff`Serial + ESP32 throws error`Tb4b4b4(Tb4b4b4) Tb4b4b4{

Tff7b72val Te6edf3manager Tff7b72= Te6edf3createManagerTb4b4b4(Ta5d6ff"Ta5d6ffs/dev/ttyUSB0Ta5d6ff"Tb4b4b4)

Te6edf3assertFailsWithTff7b72<Te6edf3IllegalStateExceptionTff7b72> Tb4b4b4{ Te6edf3managerTb4b4b4.Te6edf3getHandlerTb4b4b4(Te6edf3esp32HardwareTb4b4b4) Tb4b4b4}

Tb4b4b4}

T8b949e// ── getHandler: TCP/WiFi connection ─────────────────────────────────────

Tf0883e@Test

Tff7b72fun Td2a8ff`TCP + ESP32 routes to OTA handler`Tb4b4b4(Tb4b4b4) Tb4b4b4{

Tff7b72val Te6edf3manager Tff7b72= Te6edf3createManagerTb4b4b4(Ta5d6ff"Ta5d6fft192.168.1.100Ta5d6ff"Tb4b4b4)

Tff7b72val Te6edf3handler Tff7b72= Te6edf3managerTb4b4b4.Te6edf3getHandlerTb4b4b4(Te6edf3esp32HardwareTb4b4b4)

Te6edf3assertIsTff7b72<Te6edf3Esp32OtaUpdateHandlerTff7b72>Tb4b4b4(Te6edf3handlerTb4b4b4)

Tb4b4b4}

Tf0883e@Test

Tff7b72fun Td2a8ff`TCP + nRF52 throws error`Tb4b4b4(Tb4b4b4) Tb4b4b4{

Tff7b72val Te6edf3manager Tff7b72= Te6edf3createManagerTb4b4b4(Ta5d6ff"Ta5d6fft192.168.1.100Ta5d6ff"Tb4b4b4)

Te6edf3assertFailsWithTff7b72<Te6edf3IllegalStateExceptionTff7b72> Tb4b4b4{ Te6edf3managerTb4b4b4.Te6edf3getHandlerTb4b4b4(Te6edf3nrf52HardwareTb4b4b4) Tb4b4b4}

Tb4b4b4}

T8b949e// ── getHandler: Unknown / null connection ───────────────────────────────

Tf0883e@Test

Tff7b72fun Td2a8ff`Unknown connection type throws error`Tb4b4b4(Tb4b4b4) Tb4b4b4{

Tff7b72val Te6edf3manager Tff7b72= Te6edf3createManagerTb4b4b4(Ta5d6ff"Ta5d6ffz_unknownTa5d6ff"Tb4b4b4)

Te6edf3assertFailsWithTff7b72<Te6edf3IllegalStateExceptionTff7b72> Tb4b4b4{ Te6edf3managerTb4b4b4.Te6edf3getHandlerTb4b4b4(Te6edf3esp32HardwareTb4b4b4) Tb4b4b4}

Tb4b4b4}

Tf0883e@Test

Tff7b72fun Td2a8ff`Null address throws error`Tb4b4b4(Tb4b4b4) Tb4b4b4{

Tff7b72val Te6edf3manager Tff7b72= Te6edf3createManagerTb4b4b4(Tff7b72nullTb4b4b4)

Te6edf3assertFailsWithTff7b72<Te6edf3IllegalStateExceptionTff7b72> Tb4b4b4{ Te6edf3managerTb4b4b4.Te6edf3getHandlerTb4b4b4(Te6edf3esp32HardwareTb4b4b4) Tb4b4b4}

Tb4b4b4}

T8b949e// ── getTarget ───────────────────────────────────────────────────────────

Tf0883e@Test

Tff7b72fun Td2a8ff`Serial target is empty string`Tb4b4b4(Tb4b4b4) Tb4b4b4{

Tff7b72val Te6edf3manager Tff7b72= Te6edf3createManagerTb4b4b4(Ta5d6ff"Ta5d6ffs/dev/ttyUSB0Ta5d6ff"Tb4b4b4)

Te6edf3assertEqualsTb4b4b4(Ta5d6ff"Ta5d6ff"Tb4b4b4, Te6edf3managerTb4b4b4.Te6edf3getTargetTb4b4b4(Ta5d6ff"Ta5d6ffanythingTa5d6ff"Tb4b4b4)Tb4b4b4)

Tb4b4b4}

Tf0883e@Test

Tff7b72fun Td2a8ff`BLE target is the passed address`Tb4b4b4(Tb4b4b4) Tb4b4b4{

Tff7b72val Te6edf3manager Tff7b72= Te6edf3createManagerTb4b4b4(Ta5d6ff"Ta5d6ffxAA:BB:CC:DD:EE:FFTa5d6ff"Tb4b4b4)

Te6edf3assertEqualsTb4b4b4(Ta5d6ff"Ta5d6ffAA:BB:CC:DD:EE:FFTa5d6ff"Tb4b4b4, Te6edf3managerTb4b4b4.Te6edf3getTargetTb4b4b4(Ta5d6ff"Ta5d6ffAA:BB:CC:DD:EE:FFTa5d6ff"Tb4b4b4)Tb4b4b4)

Tb4b4b4}

Tf0883e@Test

Tff7b72fun Td2a8ff`TCP target is the passed address`Tb4b4b4(Tb4b4b4) Tb4b4b4{

Tff7b72val Te6edf3manager Tff7b72= Te6edf3createManagerTb4b4b4(Ta5d6ff"Ta5d6fft192.168.1.100Ta5d6ff"Tb4b4b4)

Te6edf3assertEqualsTb4b4b4(Ta5d6ff"Ta5d6ff192.168.1.100Ta5d6ff"Tb4b4b4, Te6edf3managerTb4b4b4.Te6edf3getTargetTb4b4b4(Ta5d6ff"Ta5d6ff192.168.1.100Ta5d6ff"Tb4b4b4)Tb4b4b4)

Tb4b4b4}

Tf0883e@Test

Tff7b72fun Td2a8ff`Unknown connection target is empty string`Tb4b4b4(Tb4b4b4) Tb4b4b4{

Tff7b72val Te6edf3manager Tff7b72= Te6edf3createManagerTb4b4b4(Ta5d6ff"Ta5d6ffz_unknownTa5d6ff"Tb4b4b4)

Te6edf3assertEqualsTb4b4b4(Ta5d6ff"Ta5d6ff"Tb4b4b4, Te6edf3managerTb4b4b4.Te6edf3getTargetTb4b4b4(Ta5d6ff"Ta5d6ffsomethingTa5d6ff"Tb4b4b4)Tb4b4b4)

Tb4b4b4}

Tb4b4b4}